Crate stretto

Stretto is a pure Rust implementation for https://github.com/dgraph-io/ristretto.

A high performance thread-safe memory-bound Rust cache.

Structs

• AsyncCacheasync
  AsyncCache is a thread-safe async implementation of a hashmap with a TinyLFU admission policy and a Sampled LFU eviction policy. You can use the same AsyncCache instance from as many threads as you want.
• AsyncCacheBuilderasync
  The AsyncCacheBuilder struct is used when creating AsyncCache instances if you want to customize the AsyncCache settings.
• Cachesync
  Cache is a thread-safe implementation of a hashmap with a TinyLFU admission policy and a Sampled LFU eviction policy. You can use the same Cache instance from as many threads as you want.
• CacheBuildersync
  The CacheBuilder struct is used when creating Cache instances if you want to customize the Cache settings.
• DefaultKeyBuilder
  DefaultKeyBuilder is a built-in KeyBuilder for the Cache.
• Histogram
  Histogram stores the information needed to represent the sizes of the keys and values as a histogram.
• Item
  Item is the parameter when Cache reject, evict value,
• TransparentHasher
  Dummy hasher will do nothing. Used by TransparentKeyBuilder.
• TransparentKeyBuilder
  TransparentKeyBuilder converts key to u64. If the key does not implement the trait TransparentKey, please use DefaultKeyBuilder or write a custom key builder.
• ValueRef
  ValueRef is returned when invoking get method of the Cache. It contains a RwLockReadGuard and a value reference.
• ValueRefMut
  ValueRefMut is returned when invoking get_mut method of the Cache. It contains a RwLockWriteGuard and a mutable value reference.

Enums

• CacheError
  CacheError contains the error of this crate
• MetricType
  The data field in a Metrics
• Metrics
  Metrics is a snapshot of performance statistics for the lifetime of a cache instance.

Traits

• CacheCallback
  CacheCallback is for customize some extra operations on values when related event happens.
• Coster
  Cost is a trait you can pass to the CacheBuilder in order to evaluate item cost at runtime, and only for the insert calls that aren’t dropped (this is useful if calculating item cost is particularly expensive, and you don’t want to waste time on items that will be dropped anyways).
• KeyBuilder
  KeyBuilder is the hashing algorithm used for every key. In Stretto, the Cache will never store the real key. The key will be processed by KeyBuilder. Stretto has two default built-in key builder, one is TransparentKeyBuilder, the other is DefaultKeyBuilder. If your key implements TransparentKey trait, you can use TransparentKeyBuilder which is faster than DefaultKeyBuilder. Otherwise, you should use DefaultKeyBuilder You can also write your own key builder for the Cache, by implementing KeyBuilder trait.
• TransparentKey
  Implement this trait for the key, if you want to use TransparentKeyBuilder as the KeyBuilder for the Cache.
• UpdateValidator
  By default, the Cache will always update the value if the value already exists in the cache, this trait is for you to check if the value should be updated.